针对具有最大距离限制的轴组，命令一个永不停止的控制运动以指定速度移动，当轴到达最大距离时将自动停止。
命名空间：IntervalZero.KINGSTAR.Local.Api
组合： IntervalZero.KINGSTAR.Local.Api (于 IntervalZero.KINGSTAR.Local.dll) 版本：4.4.0.0
语法
public KsCommandStatus InchGroup(
int Index,
double[] Distance,
double[] Velocity,
double Acceleration,
double Deceleration,
double Jerk,
McCoordSystem CoordSystem
)Public Function InchGroup(
Index As Integer,
Distance As Double(),
Velocity As Double(),
Acceleration As Double,
Deceleration As Double,
Jerk As Double,
CoordSystem As McCoordSystem
) As KsCommandStatus参数
Index [in]
型别：int
轴组的索引。索引以 0 为起始。最多可有 32 个轴组。
Distance [in]
型别：double[]
一项运动所移动的最大距离。
Velocity [in]
型别：double[]
指定速度的值。[单位/秒]
Acceleration [in]
型别：double
加速度值，单位由 McProfileType 决定（增加马达电量）。[单位/秒2] 或 [秒]
Deceleration [in]
型别：double
减速度值，单位由 McProfileType 决定（减少马达电量）。[单位/秒2] 或 [秒]
Jerk [in]
型别：double
加加速度值，单位由 McProfileType 决定。[单位/秒3] 或 [秒]
CoordSystem [in]
座标系统。仅支援 ACS。
回传值
回传 KsCommandStatus 类别。
备注
- Velocity、Acceleration、Deceleration 与 Jerk 是供轴组中各轴使用的参数，而非路径值。若这些参数，比如 Acceleration 超过轴组中其中一轴的最大 Acceleration，该轴将使用其最大 Acceleration 值，其他轴则使用提供的值。
- Velocity 与 Distance 可在轴组运作时修改。
- Distance 阵列的元素必须大于零 (> 0)，也就是说各轴移动的距离皆大于零 (> 0)。
- InchGroup 仅供轴组静止 (GroupStandstill) 状态下使用。
- 若轴组中其中一轴已完成移动而其他轴尚未完成，欲使该轴继续移动，您有两种作法：
- 增加距离。该轴将依据新运动指令所增加的距离继续移动。例如将距离从 2000 变更为 2500，当轴移动 2000 单位后将继续移动 500 单位。
- 改变该轴速度。轴将使用新的速度完成目前的距离。
重要：若距离太短但速度过快，轴的 “煞停距离” 可能会超过指定的距离，此情况可能会导致轴故障。
范例
N/A参见